home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / game / role / kangband.lha / Kangband292r2 / compile.txt < prev    next >
Text File  |  2001-04-22  |  9KB  |  195 lines
  1. This file is taken directly from Angband 2.9.2
  2. ======================================================================
  3. Compiling Angband
  4. =================
  5.  
  6. Last updated on 18th January 2001 by Robert Ruehlmann
  7.  
  8.  
  9. ----------------------------------------------------------------------
  10. Quick and dirty compilation instructions
  11. ----------------------------------------------------------------------
  12.  
  13. For many platforms (including Windows and DOS), a "pre-compiled" archive
  14. is available, which contains everything you need to install and play
  15. Angband.  For other platforms, including most UNIX systems, you must
  16. compile the source code yourself.  Try the following non-trivial steps:
  17.  
  18. Step 1: Acquire.  Ftp to "clockwork.dementia.org/angband/Source"
  19.                   Try "bin" and "mget angband*.tar.gz" and "y"
  20. Step 2: Extract.  Try "gunzip *.gz" then "tar -xvf *.tar"
  21. Step 3: Prepare.  Try "cd angband*/src", then edit "Makefile"
  22.                   You may also edit "h-config.h" and "config.h"
  23. Step 4: Compile.  Try "make", and then "cd .." if successful
  24. Step 5: Execute.  Try "angband -uTest" to initialize stuff
  25.  
  26. Step 6: Play....  Read the "online help" via the "?" command.
  27.  
  28. Of course, if you have a compiler, you can compile a (possibly customized)
  29. executable on almost any system.  You will need the "source archive" (as
  30. above), which contains the standard "src" and "lib" directories, and for
  31. some platforms (including Macintosh and Windows), you will also need an
  32. appropriate "extra archive", which contains some extra platform specific
  33. files, and instructions about how to use them.  Some "extra archives" may
  34. be found at the ftp site (including "/angband/Macintosh/ext-mac.sit.bin"
  35. and "/angband/Windows/ext-win.zip"), but be sure that you get a version
  36. of the "extra archive" designed for your Angband version.
  37.  
  38.  
  39. ----------------------------------------------------------------------
  40. DOS + DJGPP
  41. ----------------------------------------------------------------------
  42. (written by Robert Ruehlmann < rr9@angband.org >)
  43.  
  44. - Install DJGPP:
  45.     You can get the freely available DJGPP C Compiler from
  46.     < http://www.delorie.com/djgpp/ >.  On the DJGPP-page go to the
  47.     Zip-Picker < http://www.delorie.com/djgpp/zip-picker.html >.
  48.     This page helps you decide which ZIP files you need to download
  49.     and will even try to find a ftp-site near you.
  50.     If you want to have graphics and sound then you also need the
  51.     Allegro-library < http://www.talula.demon.co.uk/allegro/ >.
  52.     Get all files and follow the installation instructions.
  53. - Install the Angband source:
  54.     Get the source code archive and the untgz tool from:
  55.     < ftp://clockwork.dementia.org/angband/Tool/untgz.exe >.
  56.     Then extract the source with untgz.
  57. - Install other required files:
  58.     Get the "extra archive" from
  59.     < ftp://clockwork.dementia.org/angband/DOS-386/ext-dos.zip >.
  60.     Go to the angband directory and unzip the ext-dos archive into it.
  61.     Then get the graphics archive from
  62.     < ftp://clockwork.dementia.org/angband/Extra/angband-graf.zip >
  63.     and unzip it into the lib/xtra/graf/ folder.
  64. - Select the makefile:
  65.     Go to the src-directory and rename 'Makefile.dos' (or 'Makefile.ibm'
  66.     if you don't want graphics and sound and didn't download the Allegro
  67.     library) to 'Makefile'.
  68. - Compile Angband:
  69.     Run "make install".  Angband should now be compiled and installed
  70.     into the Angband folder.
  71. - Run Angband:
  72.     Go back to the Angband folder and run Angband.exe.
  73.  
  74. - Possible problems:
  75.     - Make exits with a 'Fatal: Command arguments too long' error message:
  76.     Such problems are usually caused by using the make.exe of another
  77.     compiler (like Borland C++ or cygwin).  DJGPP uses some clever tricks
  78.     to get around the limitations of the MS-DOS "126 characters are enough
  79.     for anybody" commandline that require a specific make tool.  So make
  80.     sure that DJGPP's make.exe is the first (or only) make.exe in your
  81.     path.  See also the DJGPP FAQ entries 16.4, 16.5, and 16.6 for further
  82.     details.
  83.  
  84.  
  85. ----------------------------------------------------------------------
  86. Windows 95/98/NT/2000 + MS Visual C++ 5.0/6.0
  87. ----------------------------------------------------------------------
  88. (written by Robert Ruehlmann < rr9@angband.org >)
  89.  
  90. - Install the Angband source:
  91.     Get the source code and the untgz tool from:
  92.     < ftp://clockwork.dementia.org/angband/Tool/untgz32.exe >.
  93.     Then extract the source with "untgz32 angband-292-src.tgz".
  94. - Install other required files:
  95.     Get the "extra archive" from
  96.     < ftp://clockwork.dementia.org/angband/Windows/ext-win.zip >.
  97.     Go to the angband-292 directory and unzip the ext-win archive into it.
  98.     Again make sure the directory structure is preserved (use the -d
  99.     option in pkunzip).
  100.     Then get the graphics archive from
  101.     < ftp://clockwork.dementia.org/angband/Extra/angband-graf.zip >
  102.     and unzip it into the lib/xtra/graf/ folder.
  103. - Open the project-file:
  104.     Go to the src-folder and open the file "Angband.dsw".  That opens
  105.     Visual C++ already properly configured for compiling Angband.
  106. - Compile Angband:
  107.     Select "Build Angband.exe" in the Build menu.  Angband should now
  108.     be compiled and the Angband.exe will be placed into the "angband-292"
  109.     directory.
  110. - Run Angband:
  111.     Go back to the Angband-folder and run the Angband.exe.
  112.  
  113.  
  114. ----------------------------------------------------------------------
  115. Windows 95/98/NT/2000 + Borland C++ 5.5 commandline tools
  116. ----------------------------------------------------------------------
  117. (written by Robert Ruehlmann < rr9@angband.org >)
  118.  
  119. - Getting the free commandline tools:
  120.     Download the Borland commandline tools from
  121.     http://www.borland.com/bcppbuilder/freecompiler/
  122.     and follow the installation instructions.
  123. - Install the Angband source:
  124.     Get the source code and  the untgz tool from:
  125.     < ftp://clockwork.dementia.org/angband/Tool/untgz32.exe >.
  126.     Then extract the source with "untgz32 angband-292-src.tgz".
  127. - Install other required files:
  128.     Get the "extra archive" from
  129.     < ftp://clockwork.dementia.org/angband/Windows/ext-win.zip >.
  130.     Go to the angband-292 directory and unzip the ext-win archive into it.
  131.     Again make sure the directory structure is preserved (use the -d
  132.     option in pkunzip).
  133.     Then get the graphics archive from
  134.     < ftp://clockwork.dementia.org/angband/Extra/angband-graf.zip >
  135.     and unzip it into the lib/xtra/graf/ folder.
  136. - Compile Angband:
  137.     Open a commandline window and go to the src-directory.  Run
  138.     "make -f makefile.bcc install".  Angband should now be compiled
  139.     and installed into the Angband folder.
  140. - Run Angband:
  141.     Go back to the Angband-folder and run the Angband.exe.
  142.  
  143. - Possible problems:
  144.     - Make exits with a "Command line too long" error message:
  145.     Try to add the -l option to the make command.  The make util
  146.     should have the "use long command lines" option enabled by
  147.     default, but some people reported that this is not always
  148.     the case.
  149.  
  150.  
  151. ----------------------------------------------------------------------
  152. Windows 95/98/NT/2000 + Cygwin
  153. ----------------------------------------------------------------------
  154. (written by Robert Ruehlmann < rr9@angband.org >)
  155.  
  156. - Getting the free Cygwin compiler:
  157.     You can find the free Cygwin compiler at:
  158.     < http://sources.redhat.com/cygwin/ >.  It provides a shell
  159.     interface very similiar to a normal Unix/Linux shell with many
  160.     useful tools. Install it and start the shell.
  161. - Install the Angband source code
  162.     Extract the source code with "tar -xvzf angband-292-src.tgz".
  163. - Install other required files:
  164.     Get the "extra archive" from
  165.     < ftp://clockwork.dementia.org/angband/Windows/ext-win.zip >.
  166.     Go to the angband-292 directory and unzip the ext-win archive into it.
  167.     Then get the graphics archive from
  168.     < ftp://clockwork.dementia.org/angband/Extra/angband-graf.zip >
  169.     and unzip it into the lib/xtra/graf/ folder.
  170. - Compile Angband:
  171.     Go to the src-directory.  Run "make -f makefile.cyg install".
  172.     Angband should now be compiled and installed into the Angband folder.
  173. - Run Angband:
  174.     Go back to the Angband-folder and run the Angband.exe.
  175.  
  176.  
  177.  
  178. ----------------------------------------------------------------------
  179. Linux + GCC
  180. ----------------------------------------------------------------------
  181. (written by Robert Ruehlmann < rr9@angband.org >)
  182.  
  183. - Install the Angband source:
  184.     Extract the source code with "tar -xvzf angband-292-src.tgz".
  185. - Install the graphics files:
  186.     If you want to use graphics under X11 then get the archive from
  187.     < ftp://clockwork.dementia.org/angband/Extra/angband-graf.zip >
  188.     and unzip it into the lib/xtra/graf/ folder.
  189. - Compile Angband:
  190.     Run "./configure", "make", and "make install" in the Angband
  191.     directory.
  192. - Run Angband:
  193.     Start Angband with "angband".
  194.  
  195.